home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-18 / bualarm.zip / ALARM.DOC < prev   
Text File  |  1991-05-10  |  8KB  |  186 lines
  1.  
  2.  
  3.  
  4.         ALARM.COM
  5.         ======
  6.         
  7.         ALARM.COM   is  a  hard  disk  back-up  reminder.  It  is   designed 
  8.         specifically  for those who - like me - prefer to back  up  their 
  9.         entire  hard disk regularly - I do mine on a monthly basis -  and 
  10.         back  up individual sub-directories containing  development  work 
  11.         and data as changes are made. 
  12.         
  13.         ALARM works by looking at a file on the hard disk which contains the 
  14.         date of the last back-up, and comparing it to todays date. If the 
  15.         interval  between  the  dates is more than  the  preset  interval 
  16.         between back-ups, a gentle reminder is given that the back-up  is 
  17.         overdue.  To  be used effectively BK must be run  each  time  the 
  18.         computer  is  used,  and  should  therefore  be  placed  in   the 
  19.         AUTOEXEC.BAT file. The syntax is:
  20.         
  21.         ALARM (Option) where Option is either:
  22.         
  23.             a 2 digit number representing the interval between backups
  24.             or the Date of last Backup as dd/mm/yy
  25.         
  26.         If an interval between back-ups is not specified, the default  is 
  27.         28 days. 
  28.         
  29.         
  30.         USE
  31.         ===
  32.         
  33.         Initialise ALARM by typing:
  34.         
  35.         ALARM (date) 
  36.         
  37.         where  [date]  is  the  date of the  last  back-up  in  the  form 
  38.         dd/mm/yy.  ALARM will create a file called BACKCHK.DAT in  the  root 
  39.         directory of the current logged on drive, which if typed out will 
  40.         look like:
  41.         
  42.         Last Backed-Up On : 12/04/91
  43.         
  44.         Running  ALARM  again  -  without any options  -  will  display  the 
  45.         following:
  46.         
  47.         
  48.           /--------------------------------\ 
  49.           |     Back-up Reminder  v2.10    | 
  50.           |     Paul Martin      May 1991  | 
  51.           |                                | 
  52.           |  Todays Date       : 01/05/91  | 
  53.           |  Checking drive    : C:        |
  54.           |  Last Backed-Up On : 29/05/91  | 
  55.           |  Interval set at   : 28        | 
  56.           |  Days since backup : 18        | 
  57.           \--------------------------------/ 
  58.         
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.         Assuming  that  the last back-up was carried out on  the  1st  of 
  66.         March  1991,  running ALARM will result in  the  following  being 
  67.         displayed - along with an audible reminder.
  68.         
  69.         
  70.           /--------------------------------\                           
  71.           |     Back-up Reminder  v2.10    |                           
  72.           |     Paul Martin    May 1991    |                           
  73.           |                                |                           
  74.           |  Todays Date       : 10/05/91  |                           
  75.           |  Checking dive     : C:        |
  76.           |  Last Backed-Up On : 01/03/91  |                           
  77.           |  Interval set at   : 28 /---------------------------------\ 
  78.           |  Days since backup : 71 |                                 | 
  79.           \-------------------------|   B A C K U P  O V E R D U E    | 
  80.                                     |                                 | 
  81.                                     |                                 | 
  82.                                     | To Change Date of Last Back-up  | 
  83.                                     |       - press [SPACE]  -        | 
  84.                                     | To Ignore Reminder and Continue | 
  85.                                     |       - press [RETURN] -        |
  86.                                     \---------------------------------/ 
  87.         
  88.         Pressing  just  the  RETURN key will leave  the  program  without 
  89.         further  action,  but assuming a back-up has  been  carried  out, 
  90.         pressing the SPACE bar will present the opportunity to alter  the 
  91.         date held in ALARMAH.DAT.
  92.         
  93.         
  94.           /--------------------------------\                            
  95.           |     Back-up Reminder  v2.10    |                            
  96.           |     Paul Martin    May 1991    |                            
  97.           |                                |                            
  98.           |  Todays Date       : 10/05/91  |                            
  99.           |  Checking dive     : C:        |
  100.           |  Last Backed-Up On : 01/03/91  |                            
  101.           |  Interval set at   : 28 /---------------------------------\  
  102.           |  Days since backup : 71 |                                 |  
  103.           \-------------------------|   B A C K U P  O V E R D U E    |  
  104.                                     |                                 |  
  105.                                     |                                 |  
  106.                                     |  Set Date of last Backup :      |  
  107.                                     |                                 |  
  108.                                     |    <01/03/91> :   /  /          |  
  109.                                     |                                 |
  110.                                     \---------------------------------/  
  111.         
  112.         
  113.         Todays date is presented as the default, and pressing RETURN will 
  114.         use this date. Any other date can be entered instead. 
  115.         
  116.         NOTE:  As with the initialisation, the date held  in  ALARMAH.DAT 
  117.         can be changed by entering a date in the command line.
  118.         
  119.         
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.         RETURN VALUES
  127.         =============
  128.         
  129.         ALARM  returns the following values to DOS, which can be  used  with 
  130.         the IF ERRORLEVEL command in batch files:
  131.         
  132.              3 - Syntax error in command line.
  133.              2 - Backup Overdue - Date amended.
  134.              1 - Backup Overdue - Warning ignored.
  135.              0 - No backup required.
  136.         
  137.         It  would  be quite possible, for instance, to arrange  for  your 
  138.         particular backup program to be run automatically if the date  of 
  139.         the last backup is changed. 
  140.         
  141.         REMEMBER: if you use IF ERRORLEVEL, check for the highest  FIRST. 
  142.         If 2 is returned, IF ERRORLEVEL 1 will be TRUE.
  143.         
  144.         
  145.         MULTI-DRIVE MACHINES
  146.         ====================
  147.         
  148.         For  machines  with  more than one  hard  disk  drive,  different 
  149.         intervals  can  be set for each drive. The  file  ALARMAH.DAT  is 
  150.         created  in the root directory of the current drive. On a  system 
  151.         with two hard disks, the AUTOEXEC.BAT file may look like this:
  152.         
  153.         C:
  154.         C:\ALARM
  155.         D:
  156.         C:\ALARM
  157.         
  158.         Although  the PATH command could be use to tell DOS where  ALARM.COM 
  159.         is located.
  160.         
  161.         ALARM  indicated  which drive is being checked when it  is  run,  so 
  162.         there is little chance of confusion.
  163.         
  164.         
  165.         IMPORTANT
  166.         =========
  167.         
  168.         A  certain amount of syntax and date verification is carried  out 
  169.         by the program, but it is not designed to trap every  conceivable 
  170.         error.  If something does go wrong, delete ALARMAH.DAT  from  the 
  171.         root  directory,  and start again! If an error is made  with  the 
  172.         syntax on the command line, the following will be displayed:
  173.         
  174.         
  175.              ALARM.COM - Paul Martin May 1991
  176.              Syntax :  ALARM [option]
  177.              Option :  2 digit number - interval between backups
  178.                     :  Date of last Backup as dd/mm/yy
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.         
  186.